Controlling Sequence Grabber Components6

SGGrabPict

QuickTime 1.6.1 added a new flag to the grabPictCurrentImage parameter for the SGGrabPict function.



 
enum {

    grabPictCurrentImage    = 4

};

Constant descriptions

grabPictCurrentImage: Set this flag to 1 to provide the fastest possible image capture. Although this flag may fail under certain circumstances, this failure is recoverable; it just will not return a picture. You can then call SGGrabPict again without the flag set. This routine does not pause the current preview or grab the next frame; it just causes the currently displayed image to be captured. It's a good idea to call SGPause before calling SGGrabPict with this flag.

SGGetMode

The SGGetMode function returns the mode for a sequence grabber component.



 
pascal ComponentResult SGGetMode (

                     SeqGrabComponent s,

                     Boolean *previewMode,

                     Boolean *recordMode);

s: Specifies the component instance that identifies your connection to the sequence grabber component. You obtain this value from the Component Manager's OpenDefaultComponent or OpenComponent function.
previewMode: Contains a pointer to a Boolean. The sequence grabber component sets this field to true if the component is in preview mode.
recordMode: Contains a pointer to a Boolean. The sequence grabber component sets this field to true if the component is in record mode.

DISCUSSION

The SGGetMode function provides a convenient mechanism for determining whether a sequence grabber component is in preview mode or record mode.